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Functions  for  Trapping  Exceptions 


Returns  the  numeric  value  for  the 
error  code 


^M^RM^ 

Returns  the  message  associated  with 
the  error  number  ^T>^ 
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Functions  for  Trapping  Exceptions 


Example 


DECLARE 

v_error_code 
v_error_me s  sage 

BEGIN 


NUMBER; 

VARCHAR2 (255)  ; 


EXCEPTION 

•    •  • 

WHEN  OTHERS  THEN 
ROLLBACK; 

v_error_code   :=  SQLCODE  ; 
v_error_message   :=  SQLERRM  ; 

INSERT  INTO  errors 


VALUES (v_error_code ,  v_error_message) ; 


END 
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Trapping  User-Defined  Exceptions 


Declare 


Declarative 
section 


Name  the 
exception 


Executable 
section 


Explicitly  raise 
the  exception  by 
using  the  RAISE 
statement 
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User-Defined  Exception 


Example 


u 


EXCEPTIQ 


DECLARE 

e_inva 
BEGIN 

UPDATE  product 

SET  descrip  =   '  &product_description ' 

WHERE  prodid  =  &product_number ; 

IF  SQL%NOTFOUND  THEN 

RAISE  e_invalid_j?roduct ; 
END  IF; 
COMMIT; 

EXCEPTION  

WHEN    e_invalid_j>roduct  THEN 

DBMS_OUTPUT . PUT_LINE ( ' Invalid  product  number . ' ) ; 

END; 
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Propagating  Exceptions 


Sub-blocks  can  handle 
an  exception  or  pass 
the  exception  to  the 
enclosing  block. 

4  / 


DECLARE 

•        •  • 

e_no  rows  exception  ; 
e_integrity  exception  ; 

PRAGMA  EXCEPTION  INIT 
(e  integrity,   -7292) ; 
BEGIN- 

FOR  c_record  IN  emp_cursor  LOOP 

BEGIN 

SELECT   . . . 
UPDATE 

IF  SQL%NOTFOUND  THEN 
RAISE  e  no  rows; 

END  IF;     ~~  ~~ 
EXCEPTION 

WHEN  e  integrity  THEN  . . . 

WHEN  e"no  rows  THEN   . . . 
END ;         ~  ~ 

END  LOOP; 
EXCEPTION 

WHEN  NO  DATA  FOUND  THEN   .    .  . 

WHEN  TOU  MANY_ROWS  THEN   .    .  . 
END; 
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RAISE  APPLICATION  ERROR 


Syntax 


raise_application__error   (error_number , 

message)  ; 


A  procedure  that  lets  you  issue  user- 
defined  error  messages  from  stored 
subprograms 


-  Called  only  from  an  executing  stored 
subprogram 
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RAISE  APPLICATION  ERROR 


Used  in  two  different  places:  r^^8**^ 

•Executable  sectionT4^^^^-^^^^ 

Exception  section   '  ^^T^-t^T/^ 
Returns  error  conditions  to  the  user 
in  a  manner  consistent  with  other 
Oracle  Server  errors 
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RAISE  APPLICATION  ERROR 


•  Executable  section: 


BEGIN 


DELETE  FROM  employees 
WHERE  managerjd  =  v_mgr; 

IF  SQL  %N0  TFOUND  THEN 

RAISE_APPLICATION_ERROR(-20202, 
This  is  not  a  valid  manager"); 

END  IF; 
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RAISE  APPLICATION  ERROR 


•  Exception  section: 


EXCEPTION 

WHEN  NO_DATA_FOUND  THEN 
RAISE_APPLICATION_ERROR  (-20201, 
'Manager  is  not  a  valid  employee. '); 

END; 
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Summary 
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•  Predefined  Oracle  Server  error 

•  Non-predefined  Oracle  Server  error 

•  User-defined  error  b^^f^ 

Exception  trapping  ^\^\^>\" 
Exception  handling: 

•  Trap  the  exception  within  the 
PL/ SQL  block. 

•  Propagate  the  exception. 


Copyright  ©  CD  AC- ACTS 


Advanced  Computing  Training  School  (ACTS)  W<^F)  3Tcf^r 

Advanced  Computing  for  Human  Advancement  CDOC  iS^.  O  C  t  S 


Thank  You  ! 
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